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Lesson 2: A Rich Type System 


» After successfully completing this lesson, you 
will be able to: 


+ Articulate the considerations for choosing 
one kind of type over another 


» Correctly use each of kind of type in the 
system 


Choosing the Right Type 
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Reference Types and Value Types 


» Reference Types 
« Garbage collection (GC) heap allocated 
« Assignments copy the reference 
« Arrays are allocated out-of-line 
„ Start out as an array of null references 
« Passed by reference 


„ Actually, references to the objects are passed by 
value 


» Value Types (structs): 
= Stack allocated 
« Assignments copy the value 
« Arrays are allocated in-line 
= Arrays are arrays of the data type A 
= Passed by value Technlani £ 


Reference Types and Value Types 
+ Boxing 

+ Allocates box, copies value into it 
+ Unboxing 

+ Checks type of box, CLR copies value out 


int 1 = 123; 
abject o i 
int j = (int) o; 
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Reference Types and Value Types 
(continued) 
+ When to use what? 
+ Value types 
+ Value semantics (such as an Int32) 
+ Small instance size (< 16 bytes) 
„For efficient copying 
+ Typically immutable 


For example, int is immutable; you can’t 
change the Sness of 5 


» Use reference types everywhere else 


a 
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Using Structs 


» When to use: 
+ Act like primitive types 
+ Have an instance size under 16 bytes 
+ Are immutable 
+ Value semantics are desirable 


Using Structs: Initialization 


» What happens? 


+ The constructor for MyStruct is not run here 


+ Do not provide a default constructor 
+ Do design for a meaningful “zero” state 


+ Do not depend on a constructor always being 
run 
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Using Enums 


+ Very similar to C++ enums 


+ All integral values are legal; not just the 
defined ones 


+ Always scoped by type name 

+ Performance the same as underlying type (such 
as int) 

+ Use enums to strongly type return types, 
parameters, properties, ete. 
+ Even for Booleans 
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Using Enums (continued) 


» Use an enum instead of static constants 
+ Validate enum values 

File.Open ("foo.txt", (FileMode) 42); 
+ Do not suffix enums with “Enum” 

+ Avoid public nested enums 

+ Avoid enums for user extensible values 


Using Enums: Under the Covers 


Enum values default to 0..N 


public enum Compression I 
Zip, SuperZip, None 


public struct Compression : Enum { 
public int value__; 


public const Compression Zip = 0; 
public const Compression SuperZip 
public const Compression None = 2; 


Using Enums: Versioning 

+ Always fully specify enum values; don’t rely on 
compiler-inserted defaults 

# Defining new enum members is allowed 


+ Be careful about where you return those new 
values (should not be unexpected) 


+ Always have a default case in switch statements 


+ Use FlagsAttribute for enums that are combinable 


+ Use powers of two for enum values 


plural names 
+ Att ibuteTargets rather than AttributeTarget 
nts fi 


. Provide named mmon fla 


num AttributeTargets { 
0001, 


Using Enums: Flags Continued 


» Only use Flag enums when they represent a 
single concept 


+ AttributeTargets is good example 
+ The Reflection BindingFlags is an example 
of what not to do 
+ Contains many different concepts in a 
single value (visibility, static-ness, 
member kind, ete.) 
+ Should not be suffixed in “Flags” 


Using Classes 


+ Classes are by far the most used types 
+ Choose to use classes over any other type 


+ Prefer modeling classes based on concrete 
concepts rather than abstract concepts 


+ Examples: printers, files, folders 


A 
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Using Generic Types 


+ Allow for parameterized types 

+ Conceptually similar to C++ templates 

+ Supported in CLR and all Microsoft and active 
third-party languages 

+ Will be supported in the Common Language 
Specification (CLS) in the “Longhorn” 
timeframe 


Before Generics 


| private object 
private int 


d 


PICOUNI: 


puoli int count 
piaia ius Cau t. JA Eryaman 
MELU Coury t 277 ff Ae): 
it 


Generics 


s Lists 


Ai 


private If] elements; 
private int count; 


Lengthy Ri 
ement 


public TAhis[imt Index] 4; 
ELIN EE nen 
[Ide 


emer 


nêt) 


ingi=inelizelofi if fla 


Bei RENGU MEN 


Te ibiza EN NIS A] AA 


PASC 
Pasty 


Hila basing 
E 


gaze nati] 


Technical 


Why Use Generics 
= Allow for more strongly typed APIs (developers love 
strongly typed APIs) 
= Compile-time type checking 
< Microsoft® IntelliSense® experience is better 
= No ugly casts 
= No boxing 


« Promote consistency (example: all collections are the 
same) 


= Increase performance 
= There is less code you need to write and maintain 


A 
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Defining Generic APIs 
+ Consider using generics whenever an API 
returns or takes object 


» Do name generic type parameters with single 
letters 
+ Example: List<T> rather than 

List<ItemType>. 

+ Do not place generic types in special generic- 
only assemblies or namespaces just because 
the types are generic 
+ Example: Don't use System. IO.Generics 


+ Consider providing non-generic top type 


Generic APIs and Performance 


= Understand usability and performance implications of 
exposing generic APIs 


= Compared to creating your own strongly typed 
wrappers, generics are always better 


« Compared to loosely typed (example: ArrayList) 


« Generics are almost always a win for reference 
types (code is shared) 


+ But be much more careful with value types (code 
is not shared) 


« Most importantly, don’t use generics “just because 
you can 


« Think of each usage as creating a type! 
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Using Generic Collections 


= “Worker” Collections: Use them in internal implementation 
= List<T>, Dictionary<K,V>, Stack<T>, Queue<T> 


» Object Model Collections: Use them when returning 
collections from APIs 


» Collection<T>, ReadOnlyCollection<T>, 
KeyedCollection<K,W> 


» Collection Interfaces: Use them when accepting collection 
parameters 
» IEnumerable<T=, ICollection<T>, IList<T>, 
IDictionary<K,V> 
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Using Arrays: Mutability (continued) 


+ Callers can simply set the value and change your 
internal data structure 


* Security issue! 


# Consider using strongly typed collections rather 
than arrays for ease of use 


+ Do not us 
mutable 


eadonly and 
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+ The array reference 
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+ Callers can change the values in the array 


Using Arrays: Returning Empty 
Instances 
» Do return an empty array instead of a null reference 
< Nulls are generally unexpected to developers 
« A common usage pattern for arrays: 


foreach (char c in t.Name) { 


= Throws an unexpected exception if Name returns 
null 


« Provide an Empty member if scenario is common 
« Example: String.Empty 


Using Exceptions 


< Terminology exceptions are “thrown” 
= Suffix with “Exception” 
= Use exceptions rather than error codes 
s Robust: failures get noticed 
* Your method is defined to do something... 
= If it succeeds in performing its purpose, return 
« If it fails to do what it was written to do, throw an 


exception 


Using Exceptions: Continued 


= Do not just map error codes on to a single exception 
with an error code property (example: the 
WMIException) 


= Use separate exception types if this is really 
necessary 


= Do not catch and eat exceptions 


= Exceptions should be handled only where there is 
enough context to do the right thing 


« That is rarely true in a low-level library 
« An example of what NOT to do is File.Exists(} 


= It catches all exceptions and returns false, so 
you have no idea what the underlying issue is 
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It is likely that exceptions are used to drive contro 
about half of all cases 


= Bad performa 


Bad programming model 
= Side note: Avoid gle 


Using Exceptions: Performance 


+ Minimize the number of exceptions you throw 
in your API's success code-paths 


+ You dorit pay for exceptions until you throw 
in managed code 


+ Throwing exceptions degrades performance 
» Perf counters tell you exactly how many 
exceptions your application is throwing 
» Consider providing a way to avoid an 
exception being thrown 


Using Exceptions: Performance 
(continued) 


int i; 
try { 
1 = Int32.Parse("123"); 


} 
catch (FormatException ) { 
Console.WriteLine ("Invalid"); 


} 


int i; 
if (!Int32.TryPrase ("123", out i)) 
1 


} 


Console.Writeline("Invalid"); 


Using Exceptions: try..finally 
+ You should use try. finally 10 times as often as 
try. catch 


+ Catches eat exceptions, making it hard to 
debug 


+ Finally allows you to clean up, but lets the 
exception continue 


+ Catch-and-rethrow has the same benefits as 
try. finally 
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Using Exceptions: Creating New 
Exceptions (continued) 
» Create new exceptions when needed 
+ Choose shallow and wide exception 
hierarchies 
» Error messages: 
+ Localize 
+ Use a complete sentence (end in a period) 


+ Don't expose privacy related information 
(such as file paths) 
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Using Attributes 


= How do you associate information with types and 
members? 


» Category of a property 

« Transaction context for a method 

= XML persistence mapping 
+ Traditional solutions 

= Add keywords or pragmas to language 

= Use external files (examples: ‚IDL, .DEF) 
= ‚NET solution: Attributes 

= A formalized notion of extensibility 


Using Attributes: Example Usage 


public class Button: Control 


{ 
[Category("Appearance")] 
[Description("Color of text in button")] 


[Browsable (true) ] 
public Color TextColor {...} 


protected override void Paint(Graphics g) { 
TextOut (g.GetHdc O, 10, 10, “Hello"); 
} 


[D1] Import ("gdi32", CharSet = CharSet.Auto)] 
static extern bool Text0utCint hDC, 
int x, int y, string text); 


Using Attributes 


» Suffix with “Attribute” 


+ Performance tip: Seal attribute classes if you 
need fast run-time lookup 


+ Specify the AttributeUsage attribute completely 
+ Don't rely on the defaults! 
„ Be as restrictive as possible 
+ You can always open it up later 


Using Attributes 
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+ AttributeTargets—Where is the attribute 
allowed to be applied? 

< Inherited—Should derived members/types 
be considered to have this attribute? 

+ AllowMultiple—ts it legal to put more than 
one instance of the attribute on a particular 


member? A 
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Using Attributes: Positional and 

Named Arguments 

+ Use constructor arguments for required 
parameters (positional arguments) 


» Provide a read-only property with the same 
name 


» Use read-write properties for optional 
parameters (named arguments) 


„ Never use overloaded constructors 


Positional 
Argument 


[AttributeUsage(AttributeTarge A] 
Al lowhul tip „tru 
Inheritedz//41se)] 

public class NameAttribye : true { 

public NameAttribupé (string userName) {..} 


public string UsefName {get {..}} 
public int Age_ {get {..} set{..}} 
} //end class = 


== Named 
[NameAttribute("Bob", Age=87)] Argument 


Using Attributes: Bad Design 


+ The “designer” slapped the 
CLSCompliant(false) attribute on the members 
just to make the warning go away 

+ Did not provide a CLS-compliant alternative 
» Result: Microsoft Visual Basic? users could 

not take advantage of this attribute 


Using Attributes: Bad Design 


Not useable from Visual Basic and other CLS- 
complaint languages 


[attributeUsage (attributeTargets. Assembly, 

AllowMultiple=false, Inherited=true)] 

public sealed class AssemblyFlagsAttribute : 
Attribute { 


[CLSComp] iant (fal se) ] 
public Assemb] yFlagsAttribute (uint flags) {} 


[cLSComp]iant(false)] 
public uint Flags { 
get {..} 


Using Attributes: Bad Design 


» The fix: 
+ Must provide a CLS-compliant way to set 
and retrieve state 
„ We shipped it, so we can't break 
compatibility 
+ Must pick a new property name since 
properties cannot differ only in return type 
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Using Attributes: Bad Design 
+ The fi 


[AttributeUsage (AttributeTargets.Assembly, 
AllowMultiple=false, Inherited=true)] 
public sealed class AssemblyFlagsAttribute : 
Attribute { 
[CLSComp] iant (fal se) ] 
[Obsolete("use int32 version")] 


public AssemblyFlagsAttribute int flags) {} 


public Assembl yFl agsAttribute (int 
assemblyFlags) {} 


[CLSComp] iant (fal se) ] 
[Obsolete("use Asssembl yFlags property") ] 


public uint Flags { get {..} } 


public int AssemblyFlags { get {..} } 


Static Classes 


+ Static classes contain just static members 
+ Compromise between pure object-oriented 
(00) design with usability 
+ Commonly used for: 
+ Shortcuts for other operations 
(System IO File) 
+ Functionality for which a full OO wrapper is 
unwarranted (System.Environment) 
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Static Cla : Under the Covers 


public static class Environment { 
public static string CommandLine { 
get {..} 


public abstract sealed class Environment 
1 
public static void Exit(int exitCode) 
Tee} 
public static string CommandLine { 
get {..} 
} 
} 


Static Classes 


» Best used when: 
+ There is a clear charter for the class 
„ Not a “miscellaneous” bucket 
„ Not the center point of a design 
» Use sparingly 
+ Watch out for disconnected design 
„ Static classes: 
„ Are sealed 
+ Have private default constructor 
+ Have no instance members A 
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+ Late in the final mile e added a method to 
tell if the runtime is being shut dow 


added the method as an instance 
npletely uncallab 


+ However, we 
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public sealed cla: ronment 
mmentO {} //Prevent creation 
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Exercise: Choosing the Right Type 


+ Your design team wants 
+ A type that represents a document 


+ A type that represents a rational 
number 


+ A way to mark types as serializable 
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Exercise: What Is Wrong with This 
Type? 


public const int Monday = 
public const int Tuesday = 
public const int Ven = 3; 
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Exercise: What Is Wrong with This 
Type? 


public class PrinterOnFireError : 
Exception { 


public PrinterOnFireError ( 
string printerName) {} 
public PrinterOnFireError ( 
string printerName, 
string message) {} 
public PrinterOnFireError ( 
string printerName, 
string message, 
Exception InnerException) {} 
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Exercise: What Is Wrong with This 
Type? 


[Flags] 
4 public enum Color { 
Red, Green, Blue 
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Exercise: What Is Wrong with This 
Type? 
public class FileloPath { 


public static string 
GetFileName(string path) {} 


public static string 
GetRootDir (string path) {} 
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Exercise: What Is Wrong with This 
Type? 


public class CodeReviewer : Attribute { 
public CodeReviewer (string alias) {} 
public CodeReviewer (string alias, 
ant level} {} 
public int Level {get{}; set{}} 
public string Revieweralias {get {}} 
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Lesson 2 Summary 


+ Use the right type for the right job 
+ Value types for “primitive” types 
+ Enums for named constants 
+ Classes in most cases 
+ Exceptions for error handling 
+ Attributes for “custom keywords 
+ Static classes for utilities 
+ And be careful with arrays 


” 


8 2004 wiar areh Corporation. MIT righty rezervat. 
Bisse) ce reale ted temari da ten Dita Ai 

romer of wohn] corpi er sd ee 
foe be the tenderer SE Sher paie tamar. 


